home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Utilities / Text / OzTeX 1.9 / Dvips / Readme.dvips < prev    next >
Encoding:
Text File  |  1995-01-31  |  4.1 KB  |  83 lines  |  [TEXT/ttxt]
  1. This folder contains Tom Kiffe's dvips program for use with OzTeX.
  2. See OzTeX's Read-Me file for installation instructions and details about
  3. Tom's shareware fees.
  4.  
  5. This is a fairly minimal version of dvips.  Tom's full CMacTeX distribution
  6. contains a lot of other stuff that you might find useful, including a native
  7. PowerPC version of dvips and other related tools like afm2tfm, psnup, etc.
  8. Get these files from any CTAN archive in /tex-archive/systems/mac/cmactex.
  9. Get the Readme.Index file first; it tells you which files you need.
  10.  
  11. Dvips is a port of Tom Rokicki’s dvips5516 to the Macintosh.
  12. The source for the dvips manual is supplied in the "dvips.tex" file.
  13. Typeset this file using Plain TeX.  The file "test.tex" is a useful test.
  14.  
  15. People who run dvips from OzTeX need not read the following material.
  16. It is provided in case you want to run dvips directly.
  17.  
  18. RUNNING DVIPS
  19.  
  20. The command line arguments of the Unix version of dvips have 
  21. been replaced by menu selections in the Mac version. Upon start-up,
  22. the program reads the config.ps file. Since the default values 
  23. given in this file will be overwritten if a different config file is called, 
  24. their values are not reflected in the Options menu. The options to 
  25. dvips which are just switches are set from the Options menu by 
  26. choosing one of two values. If you click the "Send No" button, the option 
  27. is turned off and the default setting is overridden, and if you click 
  28. the "Send Yes" button, the option is turned on, again overriding the 
  29. default value. If neither of these buttons are set no additional 
  30. information about the particular option will be sent to dvips.
  31.  
  32. If dvips is not doing what you want, hold down the 
  33. option key while selecting "Run" from the File menu and the 
  34. program will print the actual Unix command line which is being 
  35. sent to dvips. The first option passed to dvips is the name of any
  36. additional configuration file.  After reading this file, dvips will then
  37. process any options you have explicitly set from the Options menu.
  38.  
  39. Dvips has a transfer menu which allows the user to launch other
  40. applications from within dvips. This menu is configured by variables
  41. set in dvips.env.
  42.  
  43. RUNNING DVIPS IN COMMAND MODE (À LA UNIX)
  44.  
  45. The first option under the Options menu is "Use command mode."
  46. If this item is selected dvips runs like a Unix program in that all 
  47. options except the input and output files are entered on a 
  48. command line. The input file name and the (optional) output file 
  49. name are still entered from the File menu. When you now select 
  50. “Run”, dvips prints the Unix command line and waits for the user to 
  51. enter any options and press return.
  52.  
  53. AUTOMATIC FONT GENERATION
  54.  
  55. Automatic font generation is supported by sending Apple Events to
  56. Metafont and GFtoPK in order to build any missing pk files.  When dvips
  57. cannot find a pk file, it generates the needed pk file and then continues
  58. processing the dvi file.  If the automatic font generation in dvips is
  59. turned off, dvips records the commands needed to produce the missing pk
  60. fonts in a file called "missfont.log."
  61.  
  62. To use this feature you will need a complete Metafont set-up,
  63. i.e., inimf and all the .mf input files.  You also need a base file
  64. called mf.base built with inimf.  The default Metafont mode used by dvips
  65. is "laserwriter", i.e., 300 dpi fonts for a LaserWriter. If you wish to
  66. use a different default mode, change the mode option in config.ps.
  67.  
  68. Please note that dvips only generates missing pk files.  If you encounter a
  69. missing tfm file when running TeX, there is no way to generate a dvi file
  70. and thus have dvips generate the missing font.  In this situation you have
  71. to generate the tfm file manually with Metafont, run TeX to get a dvi file,
  72. and then run dvips.  Dvips will produce the appropriately sized pk files.
  73. See the documentation with Metafont on how to generate tfm and pk files
  74. manually.
  75.  
  76. POSTSCRIPT FONTS
  77.  
  78. If you use PostScript fonts with your TeX documents, be sure to read the
  79. dvips manual.  You may have to make changes to "psfonts.map" in order for
  80. dvips to recognize the PostScript fonts and not try to make spurious pk
  81. fonts. This Macintosh port of dvips will read .pfa and .pfb files, as
  82. well as the special Macintosh PostScript font files with creator 'LWFN'.
  83.